# Hero Recommended Builds

> `GET /api/academy/heroes/{hero_identifier}/builds`: Academy endpoint of the Rone Arena API.

Path parameters:
- **hero_identifier**: Hero identifier as numeric hero ID or hero name. Accepts values like `30`, `Yi Sun-shin`, or `yisunshin`.

Query parameters:
- **rank**: Rank filter. Allowed values: `all`, `epic`, `legend`, `mythic`, `honor`, `glory`.
- **lane**: Lane. Allowed values: `exp`, `mid`, `roam`, `jungle`, `gold`. from `/api/academy/heroes/{hero_identifier}/lane` 
- **size**: Number of items per page (minimum: 1).
- **index**: Page index (starting from 1).
- **lang**: Language code for localized content (default: `en`).

The response includes hero build data:
- **records**: Array of build entries, each containing:
    - **_id**: Unique record identifier.
    - **_createdAt**: Creation timestamp.
    - **_updatedAt**: Last update timestamp.
    - **data**:
        - **heroid**: Hero ID.
        - **hero_name**: Hero name.
        - **real_road**: Lane assignment ID.
        - **build**: Array of recommended builds, each containing:
            - **equipid**: List of equipment IDs.
            - **emblem**: Emblem configuration:
                - **emblemid**: Emblem ID.
                - **emblemname**: Emblem name.
                - **emblemattr**: Emblem attributes (e.g., '+10% Spell Vamp').
                - **attriicon**: Emblem attribute icon URL.
            - **battleskill**: Battle spell configuration:
                - **battleskillid**: Battle spell ID.
                - **skillname**: Spell name (e.g., 'Retribution').
                - **skillshortdesc**: Short description.
                - **skilldesc**: Full description of spell effects.
                - **skillicon**: Spell icon URL.
            - **runeid**: Rune ID.
            - **new_rune_skill**: Array of rune skill IDs.
            - **build_pick_rate**: Pick rate of the build.
            - **build_win_rate**: Win rate of the build.

This endpoint is useful for:
- Displaying historical or community-recommended builds.
- Providing backward compatibility for older integrations.
- Should be replaced with newer endpoints for up-to-date build recommendations.

## Request

`GET https://arena.rone.dev/api/academy/heroes/{hero_identifier}/builds`

### Parameters

| Name | In | Type | Required | Default | Description |
| --- | --- | --- | --- | --- | --- |
| `hero_identifier` | path | string | yes |  | Hero identifier as numeric hero ID or hero name. Accepts values like `30`, `Yi Sun-shin`, or `yisunshin`. Name matching ignores spaces/symbols and is case-insensitive (e.g., `Luo Yi` to `luoyi`). |
| `lane` | query | string | yes |  | Filter heroes by lane (`/api/academy/heroes/{hero_identifier}/lane`). One of: `exp`, `mid`, `roam`, `jungle`, `gold`. |
| `rank` | query | string | no | `all` | Rank filter for hero statistics. One of: `all`, `epic`, `legend`, `mythic`, `honor`, `glory`. |
| `size` | query | integer | no | `20` | Number of items per page. Range: 1... |
| `index` | query | integer | no | `1` | Page index for pagination. Range: 1... |
| `lang` | query | string | no | `en` | Language code for localized content. One of: `en`, `id`, `ru`, `es`, `pt`, `tr`, `ar`, `de`, `fr`, `it`, `ja`, `ko`, `th`, `vi`, `zh-CN`, `zh-TW`, `km`. |

### Example

```bash
curl -X GET 'https://arena.rone.dev/api/academy/heroes/{hero_identifier}/builds?lane=<lane>'
```

## Example response

```json
{
  "code": 0,
  "message": "OK",
  "data": {
    "records": [
      {
        "_createdAt": 1774899901345,
        "_id": "69cad2be54ae2bda46ed4019",
        "_updatedAt": 1774899901345,
        "data": {
          "big_rank": "9",
          "build": [
            {
              "battleskill": {
                "data": {
                  "__data": {
                    "skilldesc": "Deal 520 (+80*Hero Level) <font color=\"ffe63c\">True Damage</font> to the target Creep or Minion.\n<font color=\"62f8fe\">Passive</font>: Increases Creep rewards by 60% and reduces damage taken from basic Creeps by 40%. Also grants 15% additional Damage Reduction in the allied jungle during the first 2 min. Cannot share Minion rewards with allied heroes in the first 5 min.\n<font color=\"62f8fe\">Blessing:</font> Accumulate 5 Creep kills, hero kills, or assists to upgrade the spell according to the Jungling Boots' Blessing, and <Num9> kills or assists to gain <Num10> Physical Attack and Magic Power and <Num11> Max HP.",
                    "skilldescemblem": "Deal 520 (+80*Hero Level) <font color=\"ffe63c\">True Damage</font> to the target Creep or Minion.\n<font color=\"62f8fe\">Passive</font>: Increases Creep rewards by 60% and reduces damage taken from basic Creeps by 40%. Also grants 15% additional Damage Reduction in the allied jungle during the first 2 min. Cannot share Minion rewards with allied heroes in the first 5 min.\n<font color=\"62f8fe\">Blessing:</font> Accumulate 5 Creep kills, hero kills, or assists to upgrade the spell according to the Jungling Boots' Blessing, and <Num9> kills or assists to gain <Num10> Physical Attack and Magic Power and <Num11> Max HP.",
                    "skillicon": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fsvnres%2Fimg%2Fmlbb%2Fhomepage%2F100_2cd084a2661c121c347facb060a80377.png",
                    "skillid": 20020,
                    "skillname": "Retribution"
                  },
                  "battleskillid": 20020,
                  "skillshortdesc": "Jungle Special"
                }
              },
              "build_pick_rate": 0.0128607932777792,
              "build_win_rate": 0.6308437856328392,
              "emblem": {
                "data": {
                  "attriicon": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fsvnres%2Fimg%2Fmlbb%2Fhomepage%2F100_ae89ce5b37dcd804686133c8d7044430.png",
                  "emblemattr": {
                    "emblemattr": "+14 Adaptive Penetration\n+10 Adaptive Attack\n+3% Movement Speed\n",
                    "emblemattrid": "2000560",
                    "emblemname": "Assassin"
                  },
                  "emblemid": 20005,
                  "emblemname": "Assassin"
                }
              },
              "equipid": [
                3007,
                3001,
                2013
              ],
              "new_rune_skill": [
                112,
                122,
                631
              ],
              "runeid": 20005,
              "skillid": 20020
            }
          ],
          "hero_name": "\u68b5\u59ae",
          "heroid": 17,
          "real_road": 4
        },
        "id": 4236127,
        "sourceId": 2776688
      }
    ],
    "total": 1
  }
}
```

## Links

- Try it in the playground: https://arena.rone.dev/web/academy/heroes/{hero_identifier}/builds
- Academy endpoints: https://arena.rone.dev/web/academy.md
- OpenAPI schema: https://arena.rone.dev/api/openapi.json